This PR introduces the RLSSMConfig class, a specialized configuration class for Reinforcement Learning Sequential Sampling Models (RLSSM) that inherits from the newly created BaseModelConfig abstract base class (#860).

Key Features

RLSSMConfig Class

• Inherits from BaseModelConfig: Leverages the common configuration interface while adding RLSSM-specific functionality
• RLSSM-specific fields:
  • params_default: List of default parameter values (matches list_params order)
  • decision_process: Reference to the decision model (e.g., "LAN")
  • learning_process: Dictionary of learning functions for computed parameters
  • n_params, n_extra_fields: Validation counts for parameter consistency
  • decision_model, lan_model: Additional metadata for RLSSM models

Methods

• from_rlssm_dict(): Factory method to create configs from existing RLSSM dictionary structures
• validate(): Comprehensive validation ensuring parameter counts, bounds, and required fields are consistent
• get_defaults(): Returns default values and bounds for parameters (returns float instead of ParamSpec)
• to_config(): Converts RLSSMConfig to standard Config for backward compatibility
• data property: Alias for response field to support both naming conventions

Key Differences from Standard Config

• Uses params_default (list) instead of default_priors (dict) to match RLSSM parameter ordering
• Supports hierarchical structure with separate decision and learning processes
• Returns numeric defaults rather than prior distributions
• Validates consistency between parameter lists and counts

Testing

• Added 25 comprehensive tests in test_rlssm_config.py
• 100% coverage of RLSSMConfig class
• Tests cover creation, validation, defaults, conversion, and data alias functionality

Usage Example

from hssm.config import RLSSMConfig

# Create from dictionary (matching rlssm_model_config_list structure)
config = RLSSMConfig.from_rlssm_dict("rlwm", {
    "name": "rlwm",
    "description": "RLWM model with collapsing bound decision process",
    "n_params": 4,
    "n_extra_fields": 3,
    "list_params": ["alpha", "beta", "v", "a"],
    "extra_fields": ["participant_id", "trial_id", "feedback"],
    "params_default": [0.5, 0.3, 1.0, 1.5],
    "bounds": {
        "alpha": (0.0, 1.0),
        "beta": (0.0, 1.0),
        "v": (-3.0, 3.0),
        "a": (0.3, 2.5),
    },
    "decision_model": "LAN",
    "LAN": "angle",
    "data": ["rt", "response"],
    "choices": [0, 1],
})

# Validate configuration
config.validate()

# Convert to standard Config for HSSM compatibility
standard_config = config.to_config()

Related

• Depends on PR Create base config class #860 (BaseModelConfig implementation)
• Part of issue RLSSM model config #805: RLSSM model configuration refactoring